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ATTR Syntax: Attr filename [permissions] Usage : Examine or 
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specif ied permission perm= turn on specified permission -a = 

rms : d - directory file 
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EDITOR : Gordon Bentzen 

HELPERS : Bob Devries and Don Berrie 

SUPPORT : Brisbane 0S9 Level 2 User Group. 

Well, this makes issue No 12. in what I guess we could call Vol. 2 of the National 0S9 Newsletter , and I think that 
it is now an appropriate time to examine what we have achieved over the past 12 months. 

First of al 1 i we have attempted to be an information sharing device. For that to have been successful , we need to 
have information to share. Indeed? we have had some interesting tales to tell. 

Secondly, we have tried to be a vehicle for people to share their creations with other users who have similar 
interests. 

Thirdly, we have attempted to be a unifying force to make sure that our favourite system doesn't disappear into 
oblivion. 

Have we achieved any or all of these? We (Gordon, Bob and Don) have to say that, frankly, we are disappointed 1 
Apart from a few notable exceptions, the feedback of any kind has been sadly lacking. Providing a newsletter each 
month is not a task to be taken lightly. To produce a publication which averages 11 pages of text (at 115 
characters per line) for each issue is a major undertaking, and as we said in the very first issue, we could not 
continue to do that without the assistance of the readers. 

We feel that we have an obligation to the subscribers. But surely, the subscribers also have some obligations to 
their fellow readers. Time after time, we have requested input from the readers. It doesn't matter at what level 
the input is, whether is is basic beginners stuff, or material for the most advenced users, the important thing is 
that it provides ideas . 

Don't worry that your ideas may seem trivial (you know that you are interested in ANYTHING that even remotely 
relates to 0S9), or are not written in polished literary style (we can fix that, at least in our own special way). 
The important thing is that we get the feedback. Hell, this is a communal effort. Let's see if we can make it 
that. 

Having got that off our chests, the good news is that we have decided to continue to produce the newsletter for 
another twelve months (starting, of course, from September). The subscription will remain the same as last year, 
that is $18.00. I guess that you could take this as a gentle reminder that you should budget for your newsletter 
subscription in the next couple of months. That applies to everybody, regardless of when you actually subscribed. 
All readers will have recieved back issues to take them to the common renewal date starting in September. (SCREAM 
IF YOU HAVEN'T) 

We are fortunate to have recieved some public domain material from the USA recently. Some of that is presented in 
this issue. Don has bitten the bullet, and has started into OSK (Atari style), and he has included some initial 
thoughts for your information. Bob presents the next installment in his database series. We have also included 
some further articles which we are sure will be of interest to you. 

We have again had some problems with people being unable to read disks when returned from us. Once again, please, 
when sending disks for copies of material from our public domain library, please format your disks in your own 
drives to your desired format before you send them to us. That way, you will be sure that you can read them when 
they are returned. 

We hope you enjoy our current issue, until next month. Regards. Gordon Bentzen. 
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7>£ OS-K EXPERIENCE 



Weill there comes a time when we all have to bite the bullet. One day recently, I was using my MS-DOS machine (as 
a terminal to my CoCo running OS-9) and I thought, why do I keep this thing, surely not just as a terminal for the 
CoCo. However, it had become just that, a rather expensive terminal (with a 30 mB hard drive). So, I reasoned, if 
that is all that 1 really use it for, why not sell it and get something else? Great idea. 

So what should I buy? Obviously a 69383 machine, but!! The great choice 1 An Atari, or an Amiga. Finally, I founri 
a second-hand Atari 520ST with a 1 mB ram expansion, and price decided the issue for me. (A Macintosh was out of 
the question - for obvious reasons) 

So to ATARI OS-9. Booted the system up, and familiar things started to happen. Drive lights came on, and yes, 
there is the set i me prompt. Mmmm accepts the same familiar input string for the date. Then on the screen: 2, 3, 
A, 5-6-7, etc. Heck, what's all this? Suddenly, the background turns from white to blue, and the foreground turns 
from black to white, and everything stops!! What's happened? Press a key, and suddenly you are prompted to supply 
a username. Reply with a return, and the screen fills with a message which is obviously the login command's MOID 
file. The prompt finally appears - Super: 

What do we do first? Of course, dir /D0. That works, let's try the execution directory. Try dir x. What? Error 
#216. Try dir /D0/CMDS. That seems to work fine. Finally (didn't read the manual of course) try dir -? and, wow!' 
Inbuilt help. What, dir ->:, try that. Yes that's the trick ... it works fine. Wildcard support? Of course. 
Just like UNIX. But hang on, what were all those numbers that appeared when the system was booting up. I know, I 
will have a look at the startup file. List /DB/startup. This is what I got: 

-t -np 



* OS-9/68000 Level I VI. 2 * 

* Copyright 1985 by flicroware Systems Corporation * 

* * 

* ATARI 1640 STF * 

* * 

* initializing ... * 



-nt 

* initialize the system 

* 

setime -s -d \* start system clock 

link shell cio link ,** make shell, cio and link stay in memory 

iniz dfl dl r0 ,** initialize devices 

>:mode /tl baud= 19200 ;* terminal at 19200 baud 

iniz tl ,'* initialize serial port 

kill 2 

kill 3 

skey /dfl/sys/scred.sky & ,'* load keyboard image for scred 

chd /r0 S* change to ramdisk 

makdir SYS 5* nake SYS-Directory 

copy /dB/SYS/* -w=SYS -pb=20 &;* and copy SYS-Files 

xmode /term pause 
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load load mdir dir scred & ;* load some useful utilities 

load ident copy procs mfree & 

load date del dir del makdir & 

load attr build list login & 

tsmon /tl & ;* activate user terminal 

setime </term ;* read current time and date 

ex tsmon /term 

And as it turns out, all of those numbers &re process numbers, all started from the startup file, and running 
concurrently. And that's the real thing that takes getting used to. The speed of the system (especially after 
being used to C0C0 Os-9) and OS-K's ability to run many concurrent processes without slowing appreciably, It is 
perfectly feasible to be DSAVEing from one disk to another* listing a file to the printer, and using the text 
editor, all at the same time, You can do it with a CoCo provided that you have a 'no-halt 1 controller, and can 
accept the slow keyboard response, but isn't anywhere near as elegant as with SS-K. 

Bo this is just a starter, I will continue with my explorations of OS-K, and keep you informed over the next few 
months. 

Don Berrie. 

cooococoooOOOOOOOOOOoooooooooo 
The 0S9 Operating System 



I will continue this month with more comments on the OS? operating system for the CoCo Color Computer which will be 
based on OS? Level 2 with some differences noted as applicable to Level 1. 

OS? Level 2 Modules. Some modules have been discussed in earlier newsletter articles, so let's continue with a 
description of the function of a few more. 

INIT System initialization table 

CLOCK Software routine time management 

I OMAN Input/output management 

REF Random block file manager 

SCF Sequential character file management 

PIPEMAN Pipe file management 

CC3DISK Color computer disk driver 

CC3I0 Color Computer input /output driver 

VDGINT Video display generator - low level routines 

GRFINT High level graphics code interpreter and interface 

WINDINT all the functions of GRFINT plus support of Muitiview functions 

The OS? Operating system can be described as having five (5) levels of operation, each of which require specific 
module types to perform the required functions. 

First level : This level contains the modules needed for 'bootstrapping" the system. This includes the 
Kernel, 0S9P2 (part two of boot), Clock and INIT, 

Second level : This level contains the Input/Output manager IOHAN which is required for performing all I/O 
processing supported by OS?. 

Third level : This level contains the file managers which perform I/O request processing for similar 
classes of I/O devices. 

Fourth level : This level contains the device drivers to handle I/O functions for specific I/O controller 
hardware. 

Fifth level : This system's fifth level contains the device descriptors which are actually small tables 
that define the device logical name, device driver and file manager for each I/O port. 
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I have covered the Kernel and Boot modules in an earlier article, so let's move on to the I/O function and modules. 

The I/O system provides all I/O services for user programmes and 0S9 itself. All I/O system calls are received by 
the kernel and passed to the I/O manager for processing. The I/O manager performs processing, such as the 
allocation of data structures for the I/O path and calls the file manager, device driver and device descriptor to 
do most of the work. 

The I/O manager (IOHAN) as well as providing the first level service of I/O system calls and passing data to the 
appropriate file manager, also maintains two important 0S9 data structures? the DEVICE TABLE and the PATH TABLE. 

When a path is opened, the I/O manager tries to link to a memory module which is named in the pathiist. This 
module will be a Device Descriptor which contains the names of the device driver and file manager for that device. 

RBF, SCF and PIPEMAN are the standard re-entrant file managers, each of which processes the raw data stream to or 
from a class of device drivers that have similar operational characteristics. A file manager removes as many 
unique characters as possible from I/O operations to ensure that similar devices conform to the 0S9 standard I/O 
and file structure. The file manager is responsible for mass storage allocation and directory processing if these 
are applicable to the class of device it serves. File managers usually buffer the data stream and issue requests 
to the kernel for dynamic allocation of buffer memory. 

They can also monitor and process the data stream, e.g. adding line-feed characters after carriage-return 
characters. 0S9 can have a number of file aanager modules. 

CC3Disk (level 2 - CoCo3) and CCDisk (level 1) are the system's device drivers (fourth level) which of course are 
the drivers for the disk drive hardware. The device driver modules are subroutine packages that perform basic, low 
level I/O transfers to or from a specific type of I/O device hardware controller. 

0S9 systems can include many other device drivers to handle I/O functions for specific hardware types, e.g. 
ACIAPak and CC3Hdisk could be the device drivers to handle specific hardware types if the system includes such 
hardware. 

CC3I0 is a standard device driver which handles Term_VD5, and Term.Win in a CoCo level 2 system. CCIO is the 
video/ keyboard driver used on a level 1 system. CC3I0 also utilizes interface modules VDGInt, GRFInt or Windlnt 
depending on the device descriptor being used. 

The VDGInt (VDG interface) performs both interface and low level routines for VDG CoCo 2 compatibility and 
has limited support for high-res screen allocation. The GRFInt interface provides the standard code 
interpretations and interface functions. The Windlnt interface comes with the Multi-View package and provides all 
the functionality of the standard GRFInt plus support of Multi-View features. So if Windlnt is used, exclude 
GRFInt. Term.VDG uses CC3I0 and VDGInt. TermJJin and ail window descriptors W, Wl, W2, etc. use CC3I0 plus 
GRFDrv, GRFInt Windlnt as required. 

The system' 5 fifth level, Device Descriptors, include those mentioned above Term.VDG, Term.Win, W, Wl, etc. and 
also the RBF (random block file) type devices e.g. D8, Dl, RB, H0 etc. Device descriptor modules are small, non- 
executable modules each of which provides information that associates a specific I/O device. Each such module 
contains its own logical name, device driver and file manager names together with initialization parameters. 

Unlike the device drivers and file managers, which operate on classes of devices, each device descriptor is 
tailored to a specific device. Every device on the system must therefore have a device descriptor. 

Well I have just about run out of steam for this month, 50 I hope that the above is useful to at least some 
readers. The 0S9 Technical manuals for Level 1 and Level 2 will provide more details on the functions and format 
of the different module types if you need it. 

This month' 5 "prattling" has reminded me of some of the diffulties in setting up device drivers and descriptors to 
suit particular hardware. A good example is that associated with disk drives. Microware's 0S9 Level 2 for the 
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CoCo 3 comes with many disk drive descriptors for almost any requirement. One notable omission is a descriptor for 
an 82 track double sided D0. If you need to make changes to the Level 2 descriptors* refer to the article by Bob 
Devries in our Jan-Feb '39 newsletter. 

It seems that some 0S9 Level 1 users are also restricted by the lack of suitable disk drive 'drivers' and 
'descriptors'. 0S9 will alley the use of a 40 track double sided drive as a 40 cylinder device. This results in a 
40 track double sided drive using both sides as if it were one device* 1443 sectors. The problem is that the Level 
1 driver CCDisk is hard coded for a single sided drive and does not look at the descriptor for this information in 
the same way the Level 2 CC3Disk does. The way I got around this problem on Level 1 was to replace CCDisk with the 
D.P.Johnson SDisk. SDisk supports all possible combinations as well as non-Tandy 0S9 disk formats. The only 
problem is that SDisk is NOT public domain* so I can not help you with that. 

This may be a project for a future newsletter* or perhaps someone out there already has a patch for the CCDisk 
module. Can anybody help? 

Weil that's all for this month. 

Regards* Gordon 

ooooooooooOOOOOOOOOOoooooooooo 
On how to convert those two-disk prograaaes to 48 or 38 track foraat. 

By Bob Devries. 

From WA comes a request for a discussion on how to transfer those programmes like DeskMate and Home 
Publisher* which come on two disks* or on a flippie* onto a 40 or S0 track disk* and still have them bootable. 

Well* here's how I would suggest you do it. First* format a disk to the format you usually use, i.e. 40 
tracks double sided or whatever. Put this in a cool dry place for future use.... 

Now* either use the RAMDISK or create a new working directory (it must not have any files in it J and make 
it your working directory (CHD /R0). for the rest of this to go ahead smoothly* you must have the following 
programmes: 

LS or FLS or FILES or D 

(a programme which lists files from the current directory to STDOUT so it can be PIPED)* and 
MODBUSTER or BOOTSPLIT 

(a programme which can split merged files like 0S9B0OT into separate files). 
SAVE 

(the save programme from level one 0S9 or from the development system disk may be used.) 

(LS is available on the Home Publisher disk in the CMDS directory) 
(D is available in our Public Domain library in volume 21) 
(BOOTSPLIT is available on Public Domain library volume 8) 
( or see my re-hashed version elsewhere in this issue) 
(MODBUSTER is supplied with SDisk3 or SDisk from D.P.Johnson) 

Put the DeskMate disk (or whichever other you're doing) into drive /Dl and type! 

MODBUSTER /dl/0S9B00T or use BOOTSPLIT (a bit more tedious) 

This will split the 0S9B00T file into its separate components so we can operate on them. DELete the disk 
device descriptors D0, Dl* and if it's there* DD. Now use the SAVE command to save those same descriptors from 
memory to your current directory like this: 
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SAVE D0 
SAVE Dl 
SAVE DD 

Remove the original DeskMate Disk, and find that freshly formatted disk and insert it into drive /Dl. Now 
where did I put that thing ? Now me can create the new boot on that disk with this command: 

LS ! 0S9GEN /Dl 

You may use D or FLS instead of LS. What happens here is that LS lists the filenames in the current 
directory to STDOUT which we PIPE into the input of 0S9GEN which in turn uses these names to create the new 
bootfile on the disk in /Dl. 

When the above command is finished! you'll have a disk with a bootfile on it with the correct disk 
descriptors in it. What we now need to do is copy across all the files. Use DSAVE or DIRCOPY to copy the files of 
both disks onto the one new disk. You'll very likely get some errors like 213 (file already exists) because some of 
the files will be duplicated on the two disks. 

When you've finished ail that, you'll have a bootable 40 or 83 track version of DeskMate or Home Publisher 
or whatever. 

oooooocoooOCOOOOOOOOoocooooooo 

A Database in C. 

By Bob Devries 

Here is part four of my on going series of the address book database in the C programming language. This 
section is the delete?) function which blanks out and removes the currently displayed record from the database. It 
also calls the saveO function (coming scon...). 

The delete function does the very simple task of asking if you're sure you want to go ahead, and when you 
answer 'Y' it sets all the fields to NULL C\0') and sets the REPLACE variable to TRUE and calls saveO to store it 
on the disk. It passes the record number and the replace variable to saveO. If you type 'N' it erases the 
question^ and goes back to the command line of the programme. 

Wei It here's the ne>;t exciting chapter. See you again soon.... 



delete(recno) 

int recno; 

/* deleteO sets the first char of the char strings in the structure to */ 

/* null and the postcode to 3 then calls saved with replace set to TRUE */' 

/* so that it will place it over the top of the current record */ 

/ 

int replace; 
char ch; 

replace = TRUE; /# replace current record */ 

cursor (13,23); 

eraselinO; /* erase message line */ 

cursor (10,23); 
printfCAre you sure ? '); 
while ((ch != 'Y') && (ch != 'NM) 
{ 

ch = toupper(getchO); 
switch (ch) 
( 
case 'Y': 

mail.surnameCB] = 5 \3'; 
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mail.firstname[0] = '\0M 
mail.street[0] = '\0'; 
■ail.cityCBl = '\3'; 
mail.stateE0] = 'UH 
mail. post code = 8? 
recno = save< recno, replace); 
cursor (10, 23); 

eraselinO; /* erase message line */ 
break; 
case 'N': 

cursor (IB, 23); 
erase! in (); 
return; 



ooooooccocOOOOOOOOOOooocoocooo 

A ^edification for Karl Kreider's Bootsplit. 
By Bob Devries 

I took pity on all of you people out there who are not able to use modbuster, and made some modifications 
to the SASICS9 programme so that it will split all the modules in the merged file you tell it. Only one gotcha* you 
must have IDENT in your current EXECUTION directory and of course RUNB to run the packed version of this programme. 
The programme creates a temporary file called 'temp' in the current DATA directory, but deletes it before it quits. 
Have fun. Oh by the way, it is sbbIIIIIoooowwwww. 

RDV 
PROCEDURE emerge 



0801 (* boot file splitter *) 

0019 

331A i* after H.Snyder *) 

002E (* from the public domain *) 

304 A (* by Karl Kr eider with mods by Bob Devries *) 

0073 (* was once called 'BootSplit' *) 

309? 

009A DIM mhead,msize,mof5,inpath,outpath,rpath,pts: INTEGER 

S0E9 DIM index: REAL 

00C0 DIM name,mname,infile,rname:STRING 

00D3 DIM chaNBYTE 

00DA DIM found'.BOOLEAN 

00E1 

30E2 INPUT 'file to break up - a ,infiie 

00FD SHELL "ident '+infile+' -s >temp' 

0117 OPEN #inpath,mfile 

0121 OPEN »r path, "temp*: READ 

3130 LOOP 

0132 EXITIF EOF(ttrpath) THEN 

013C ENDEXIT 

3140 INPUT #rpath,rname 

314A pts=SUBSTR<V,rname) 

3156 name=RI6HT$(rname,LEN(rname)-pt5-i) 

016A name=LEFT$(name,LEN(name)-i) 

017A PRINT name 
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017F 


SOSUB 1000 


0183 


IF found THEN 


018C 


CREATE #outpath,nai»e:WRITE 


0198 


SEEK ttinpath, index 


01A2 


FOR j=l TO msize 


01B5 


GET #inpath,char 


01BF 


PUT #outpath,char 


01 C9 


NEXT j 


01D4 


CLOSE #outpath 


01DA 


ELSE PRINT name; B not found' 


01EF 


ENDIF 


aiFi 


ENDLOOP 


01F5 


CLOSE #rpath 


01FB 


SHELL 'del temp" 


0207 


CLOSE #inpath 


020D 


END 


020F 




0210 1000 <* module finder *) 


0226 


found=TRUE 


022C 


inde>;=3 


0234 


msize=3 


023B 


REPEAT 


023D 


index=index+m£i2e 


924A 


SEEK #inpath, index 


0254 


EXITIF EOF(#inpath) THEN found=FAL3E 


0263 


ENDEXIT 


0267 


GET #inpath»mhead 


0271 


GET #inpath.msize 


027B 


GET #inpathii»ofs 


0285 


SEEK #inpathiindeK+mofs 


0294 


mname=" 


029B 


REPEAT 


029D 


GET ttinpathichar 


02A7 


mnane=iBnaise+CHR$ I LAND ( char , $7F ) ) 


02B3 


UNTIL char) 127 


02C3 


UNTIL naiTie=flinaiiie 


02CF 


RETURN 
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